home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / dialm50.arc / DIALM50.DOC < prev    next >
Text File  |  1990-08-19  |  14KB  |  327 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                     DIALM
  8.                          A TELEPHONE DIALING PROGRAM
  9.                                 Revision 5.0
  10.                                 
  11.                                  Written by
  12.  
  13.                                Robert Wilcox
  14.                             920 N. Washington St
  15.                             Owosso, MI     48867
  16.   
  17.  
  18.    DIALM is a telephone dialing program which was written as an exercise in
  19.    programming for the Microsoft or compatible mouse.  It was later revised so
  20.    that the mouse is not required, and phone number file maintenance and the
  21.    ability to use multiple phone number files was added.  Revision 3.0 added
  22.    the use of dialing prefixes.  Revision 3.1 corrected a minor bug and 3.2
  23.    added a help screen.  With revision 4.0 DIALM has the ability to time and
  24.    log calls.  Revision 4.1 corrected a problem with sorting large dialing
  25.    directories.
  26.  
  27.    Revision 5.0 is a completely rewritten version.  It retains most of the
  28.    features of the earlier versions and has an improved user interface
  29.    because of the use of pop-up windows.  A better method of displaying
  30.    the phone number directory allows for a much faster number search.
  31.   
  32.    DIALM runs on an IBM PC, XT or AT or compatible computer.  It requires
  33.    a HAYES or HAYES compatible modem on either port COM1 or COM2.  The program
  34.    will run without a modem, but of course dialing will not be possible.
  35.    A mouse is useful but not required.
  36.  
  37.  
  38.                                ================
  39.                                PROGRAM FEATURES
  40.                                ================
  41.    
  42.    DIALING DIRECTORIES
  43.    ===================
  44.    DIALM uses a telephone number directory file stored on disk which is
  45.    created and updated from within the program.  The directory may contain 
  46.    up to 200 entries.  Each entry contains a name, the number and an address
  47.    or other descriptive string.  Any number of directory files may be available
  48.    on disk and the one to be used can be selected from the command line or
  49.    after the program is running.
  50.  
  51.    Directory files may be on any drive or sub-directory.  The program will look
  52.    for directory files on the default drive and sub-directory unless otherwise
  53.    specified (see below).  Other drives and sub-directories can be easily
  54.    selected.
  55.    
  56.    DIALM 5.0 will use dialing drectories created with any previous version
  57.    of DIALM version 3.0 or higher.
  58.  
  59.  
  60.    SELECTING A NUMBER TO DIAL
  61.    ==========================
  62.    A number to be dialed may be selected by clicking on it with the mouse or
  63.    by pressing the ENTER key when the desired entry is displayed.  Pressing
  64.    a letter key will display the entry beginning with that letter.  Subsequent
  65.    pressings of the same letter will advance to the next entry beginning with
  66.    that letter.
  67.  
  68.    Entries may be searched for from the main menu also.  A search string is
  69.    entered and the name and description fields of each entry are searched
  70.    for a match.
  71.  
  72.    A number to be dialed may also be entered from the keyboard. 
  73.  
  74.                         ==========================
  75.                         PROGRAM FEATURES CONTINUED
  76.                         ==========================
  77.  
  78.    PREFIXES
  79.    ========
  80.    Ten dialing prefixes (A through J) are stored by the program and are
  81.    created by the user.  For instance, prefix A might be "1-800", then
  82.    the number A-555-1212 would be dialed as 1-800-555-1212.
  83.  
  84.    LOGGING
  85.    =======
  86.    A log record of calls can be maintained which will show the date, time
  87.    and length of calls.  The user may type, copy or print this file from
  88.    the command line since it is a standard ASCII (text) file.  The log
  89.    file is called "DIALM.LOG" and is stored in the root directory of the
  90.    default drive.
  91.  
  92.    ATTACK (DEMON) DIALING
  93.    =======================
  94.    When a number is dialed which is busy the program will attempt to re-dial it
  95.    after a short pause, up to 25 times.
  96.  
  97.    PROGRAM SETUP
  98.    =============
  99.    The program uses color and sound.  These features can be disabled.  The
  100.    color and sound selections are kept in the dialing directory presently
  101.    in use.  In other words, each dialing directory may be set up differently.
  102.    The selection of either pulse or tone dialing also may be made.  The modem
  103.    initialization string can also be entered if needed. 
  104.  
  105.  
  106.                         ==========================
  107.                         PROGRAM FEATURES CONTINUED
  108.                         ==========================
  109.  
  110.  
  111.    POP-UP MENUS
  112.    ============
  113.    DIALM uses pop-up menus and other windows.  Some of these are illustrated
  114.    below.
  115.  
  116. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  117.                                                                                 
  118.                       DIALM POPUP TELEPHONE DIALER   Ver. 5.0             
  119.                                                                                 
  120. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀╒══════════════════════════╕▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  121. ══════════════════════════════════════│    COMMAND SELECTIONS    │══════════════
  122.                                       │══════════════════════════│
  123.                                       │DIAL SELECTED NUMBER      │
  124.                                       │HANGUP                    │
  125.                                       │SELECT A NUMBER           │
  126.                                       │SEARCH THE DIRECTORY      │
  127.                                       │REPEAT THE SEARCH         │
  128.                                       │UPDATE THE DIRECTORY      │
  129.                                       │NUMBER FROM KEYBOARD      │
  130.                                       │EDIT PREFIXES             │
  131.                                       │LOG THIS CALL             │
  132.                                       │GET NEW DIRECTORY         │
  133.                                       │PROGRAM SETUP AND INFO    │
  134.                                       │QUIT THIS PROGRAM         │
  135.                                       ╘══════════════════════════╛
  136.  
  137. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  138.  
  139.                      DIALM POPUP TELEPHONE DIALER   Ver. 5.0 
  140.  
  141. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀╒══════════════════════════╕▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  142. ══════════════════════════════════════│    COMMAND SELECTIONS    │══════════════
  143.                                       │══════════════════════════│
  144.                   ╒═════════════════════════╕ELECTED NUMBER      │
  145.                   │    DIRECTORY = DIALM    │                    │
  146.                   │═════════  ═  ═════════│ A NUMBER           │
  147.                   │Arrow Electronics        │ THE DIRECTORY      │
  148.                   │Brush Hauling            │ THE SEARCH         │
  149.   ┌──────────┐    │Corunna TV               │ THE DIRECTORY      │
  150.   │ Main Menu│    │Eavestroughs             │ FROM KEYBOARD      │
  151.   │          │    │FAB Software             │REFIXES             │
  152.   │  [ESC]   │    │Free Press               │IS CALL             │
  153.   └──────────┘    │GTE Telephone Co         │W DIRECTORY         │
  154.                   │H&R Block                │M SETUP AND INFO    │
  155.                   │Hard Drive Int           │HIS PROGRAM         │
  156.                   │Info 313                 │════════════════════╛
  157.                   ╘═════════  ═  ═════════╛
  158.  
  159.  
  160.                                                                                 
  161.                                ============== 
  162.                                STARTING DIALM
  163.                                ==============
  164.  
  165.    If the version of the program as you obtain it is "DIALM50.EXE" you
  166.    may rename it "DIAL.EXE" for brevity.  At the DOS prompt type:
  167.  
  168.         REN DIALM50.EXE DIALM.EXE
  169.  
  170.    To start DIALM type:
  171.  
  172.         DIALM [CR] 
  173.  
  174.    where [CR] means press the RETURN button.
  175.  
  176.    If the screen is hard to read because it doesn't display color correctly,
  177.    use the command line parameter "/B" to force the program to use black and
  178.    white, i.e.,
  179.  
  180.         DIALM /B [CR]
  181.  
  182.    A directory file name may also be entered on the command line.  If one
  183.    is entered the program will attempt to use the file.
  184.  
  185.        DIALM C:\DAT\PHONES [CR]
  186.  
  187.    This will load in the directory file named PHONES.DIR in the sub-directory
  188.    DAT of drive C.
  189.  
  190.    If the /B parameter is also used, leave a space between it and the directory
  191.    file name.
  192.                                                                                 
  193.                                ===================
  194.                                USING DIALM'S MENUS
  195.                                ===================
  196.  
  197.    There are 3 ways to make a selection from the menus:
  198.  
  199.       1)  Move the mouse until the proper selection is highlighted and then
  200.           click the left mouse button.
  201.  
  202.       2)  Press the first letter of the desired selection on the keyboard.
  203.           If there are two or more selections with the same first letter,
  204.           pressing the letter again will move to the next selection starting
  205.           with that letter.  When the correct selection is highlighted, press
  206.           ENTER or the left mouse button.
  207.  
  208.       3)  Use the PAGE UP, PAGE DOWN, HOME, END and arrow keys until the
  209.           desired selection is highlighted, then press ENTER or the left 
  210.           mouse button.
  211.  
  212.    In most cases the right mouse button is the same as the ESC (escape)
  213.    keyboard key.  Try it to see what happens in each menu.
  214.  
  215.                            ERROR MESSAGES
  216.                            --------------
  217.    Sometimes a message will appear followed by a 4 second delay.  You may press
  218.    ESC on the keyboard to speed things up after you have read the message.
  219.  
  220.  
  221.  
  222.                                ====================
  223.                                ENVIRONMENT COMMANDS
  224.                                ====================
  225.  
  226.    Three program parameters can be set up at the DOS level and if set DIALM
  227.    will use these parameters automatically each time the program is run.
  228.  
  229.       1) Modem (COM) port.
  230.          DIALM will find the modem on either COM1 or COM2 (usually).  If your
  231.          modem is on COM2 you can speed things up by putting the port number
  232.          in the environment.  At the DOS prompt type:
  233.  
  234.                 SET COMPORT=2
  235.  
  236.       2) Modem baud
  237.          The program communicates with the modem at 1200 baud because that 
  238.          seemed to work better for my particular modem.  If your modem doesn't
  239.          work at 1200 baud you can specify another baud (such as 300 baud) by 
  240.          the following command:
  241.  
  242.                 SET COMPORT=:300
  243.  
  244.          If you want to specify both the port and the baud, combine the
  245.          commands:
  246.  
  247.                 SET COMPORT=2:300
  248.    
  249.          This program supports only COM1 and COM2 modem ports.
  250.  
  251.       3)  Directory file
  252.           You may specify a directory file to be used by DIALM.  This file will
  253.           be used unless overridden by a command line parameter described above.
  254.  
  255.                SET DIAL=C:\PHONE.DIR
  256.  
  257.          You should use the correct path and file name to describe your file
  258.          after the '='.
  259.  
  260.  
  261.    If you use this program regularly and need to use the SET commands mentioned
  262.    above, they should be placed in your AUTOEXEC.BAT file so they will not have
  263.    to be entered each time the system is booted up.
  264.  
  265.    If you get the error message OUT OF ENVIRONMENT SPACE, and you are using
  266.    DOS 3.2 or later, put the following line in your CONFIG.SYS FILE:
  267.  
  268.    SHELL=d:\COMMAND.COM /P /E:256
  269.  
  270.    Where d:\ is the drive and directory where your COMMAND.COM is located.
  271.    (This will probably be C:\ if you have a hard disk or A:\ if you boot from
  272.    a floppy disk.)  The environment space where the SET variables are stored
  273.    will be increased from the default 160 bytes to 256 bytes.
  274.  
  275.    If you are using DOS 3.1, use /E:16 instead of /E:256.
  276.    
  277.    If you are using DOS earlier than 3.1 the environment space can only be
  278.    increased by patching COMMAND.COM.
  279.  
  280.  
  281.  
  282.                                   =======
  283.                                   SUPPORT
  284.                                   =======
  285.  
  286.    I would be interested in hearing of any problems with the program and
  287.    will attempt to fix them in a later release.
  288.  
  289.    DIALM is distributed as user-supported software.  If you find the program
  290.    is useful you may send a donation of $5.00 to:
  291.  
  292.  
  293.  
  294.                         Robert Wilcox
  295.                         920 N. Washington St
  296.                         Owosso, MI     48867
  297.  
  298.    I can be reached through the EXEC-PC bulletin board (414) 789-4120.
  299.    Address messages to: BOB WILCOX.
  300.  
  301.    My Compuserve address is 71601,1541.
  302.  
  303.                             ==========================
  304.                             WARRANTIES AND LIMITATIONS
  305.                             ==========================
  306.  
  307.    You are granted permission to freely distribute DIALM in its
  308.    original form, without alteration, so long as this documentation is
  309.    distributed along with it and no fee is charged except for a reasonable
  310.    fee for media and shipping costs.
  311.  
  312.    I suggest that you distribute in the original ZIPped format.
  313.  
  314.    I DO NOT WARRANT THAT DIALM IS FIT FOR ANY PARTICULAR USE OR IS
  315.    MERCHANTABLE.  THIS PROGRAM IS NOT WARRANTED TO BE FREE OF BUGS, NOR
  316.    IS IT PROVIDED WITH ANY WARRANTY OF ANY KIND, EITHER EXPRESSED OR
  317.    IMPLIED.  IT IS YOUR RESPONSIBILITY TO DETERMINE WHETHER DIALM
  318.    IS SUITABLE FOR YOU.
  319.  
  320.    IN NO EVENT SHALL I BE HELD RESPONSIBLE FOR INCIDENTAL, SPECIAL OR
  321.    CONSEQUENTIAL DAMAGES, OR LOST DATA OR PROFITS TO ANY PERSON OR ENTITY
  322.    THAT MAY ARISE OUT OF THE USE OF THIS PROGRAM.
  323.  
  324. END OF DIALM.DOC                                     LAST REVISED 08/19/90
  325.  
  326.  
  327.